---
displayed_sidebar: "Chinese"
---

# quarter

## 功能

返回给定的日期值对应的季度，范围 1~4。

## 语法

```Haskell
INT quarter(DATETIME|DATE date);
```

## 参数说明

`date`: 日期表达式，支持的数据类型为 DATETIME 或 DATE。

## 返回值说明

返回值的数据类型为 INT。

如果出现以下情况，则返回 NULL。

- 输入值为空。
- 指定的日期不存在，比如 2022-02-29。
- 日期格式不正确。

## 示例

示例一：返回 DATETIME 格式日期对应的季度。

```Plain Text
SELECT QUARTER("2022-10-09 15:59:33");
+--------------------------------+
| quarter('2022-10-09 15:59:33') |
+--------------------------------+
|                              4 |
+--------------------------------+
```

示例二：返回 DATE 格式日期对应的季度。

```Plain Text
SELECT QUARTER("2022-10-09");
+-----------------------+
| quarter('2022-10-09') |
+-----------------------+
|                     4 |
+-----------------------+
```

示例三：返回当前日期对应的季度。

```Plain Text
SELECT QUARTER(NOW());
+----------------+
| quarter(now()) |
+----------------+
|              4 |
+----------------+

SELECT QUARTER(CURDATE());
+--------------------+
| quarter(curdate()) |
+--------------------+
|                  4 |
+--------------------+
```
